home *** CD-ROM | disk | FTP | other *** search
/ CD Ware Multimedia 1994 November / Cd Ware (Nro. 2) - Epimundo.iso / OS2 / PC2_170.ZIP / PC2.DOC < prev    next >
Encoding:
Text File  |  1994-06-01  |  17.5 KB  |  298 lines

  1. ******************************************************************************
  2.                                   Announcing
  3.  
  4.                    PC/2 - Programm Commander/2 Version 1.70 for
  5.                          IBM OS/2 2.x Presentation Manager
  6.                       Copyright (C) by Stangl Roman 06, 1994
  7.  
  8.                                Version 1.70 Draft
  9. ******************************************************************************
  10.  
  11. Dear Users!
  12.  
  13. PC/2 is an addon or replacement (!) for the WPS (Work Place Shell) that adds a
  14. feature, that OS/2 definitely is missing! After PC/2 is loaded you may click
  15. mouse button 1 anywhere on the Desktop to display a user-configurable
  16. Popup-Menu, where you can select an application to start. You may
  17. alternatively define a Hotkey for an application. Once the Hotkey is pressed
  18. PC/2 switches to the application, the Hotkey is defined for, or even launches
  19. the application if it isn't running already. This greatly simplifies
  20. starting any application very much - you don't have to click on folders/icons
  21. anymore to launch it - no more messed up Desktop full of folders/icons. You
  22. even don't need to install the memory consuming WPS (which saves at least 1
  23. Meg)!
  24.  
  25. Even more, PC/2 allows you to expand your Desktop 9-fold. Just move the mouse
  26. pointer over the surrounding rows and/or columns of your screen, and you will
  27. be able to scroll your Desktop up to 1 screen-width and 1 screen-height in
  28. all directions. Just imagine the virtual Desktop as a further screen available
  29. left, left and below, below,... to your physical display. Of course the Hotkey
  30. feature switches to the virtual Desktop the application is running the Hotkey
  31. is defined for. You may also switch to any Desktop by doubleclicking with
  32. mouse button 1 on the overview window of PC/2.
  33.  
  34. PC/2 also allows you to switch into a sliding focus mode, similar to
  35. X-Windows.
  36.  
  37. PC/2 has also limited seamless WIN-OS2 support, even without the WPS running.
  38.  
  39. For every application you start, a configuration file contains:
  40.     *) Program Data: Title, Path and Filename, working directory and
  41.             parameters. For DOS programs you can enter the required DOS
  42.             Settings in an entryfield. You may also configure PC/2 to
  43.             request commandline parameters before an application is
  44.             started. You can also add WPS Objects to be started.
  45.     *) Program Style: Default, Maximized, Minimized, Invisible, no autoclose
  46.             background execution
  47.     *) Program Size & Position: User selectable size and position. You may
  48.             even start an application on an virtual Desktop, if the
  49.             application doesn't overwrite  your choices. The position is
  50.             always adjusted by PC/2.
  51.     *) Program Type: WPS default, OS/2 and DOS Window or FullScreen,
  52.             Presentation Manager, WPS Object and seamless WIN-OS2.
  53.             Seamless WIN-OS2 without a WPS Object that corresponds to this
  54.             seamless WIN-OS2 session is fully supported. Seamless WIN-OS2
  55.             without a corresponding WPS Object is limited to separate
  56.             sessions.
  57.             If you know how to start all possible seamless WIN-OS2 sessions
  58.             with an OS/2 API directly, p l e a s e let me know.
  59.     *) Hotkey: You may define an hotkey to quickly switch to a certain
  60.             session.
  61.     *) Program Priority: You may adjust the priority of programs. Warning
  62.             changing the default priority may induce serious performance
  63.             problems, because you easily can give a program nothing to the
  64.             complete CPU time.
  65.  
  66. Full help is implemented, so I would suggest to read the help panels to get a
  67. impression on how you can customize PC/2 to your needs.
  68.  
  69. Installation:
  70.     *) First unpack the archive with UNZIP.
  71.     *) If you upgrade from a previous version of PC/2, save your Popup-Menu
  72.        configuration files (usually PC2.CFG), and stop PC/2 from running in
  73.        order to allow the files to be updated.
  74.        Warning! PC/2 Version 1.70 PC2HOKK.DLL is n o t compatible with any
  75.        previous version.
  76.        When using an existing configuration file the first time you click for
  77.        the Popup-Menu, the Configuration dialog is displayed, because you have
  78.        to add the Control Menuitem "Configure Popup-Menu Settings" first.
  79.     *) Then use the REXX installation script to install PC/2:
  80.        Syntax:  INSTALL <Destination>
  81.             PC/2's files will be copied into the drive, path and filename
  82.             pointed to with <Destination>. An object is then created on the
  83.             Desktop and PC/2 is then started displaying the help panels.
  84.     *) PC/2 should be started upon bootup. You can either click on the PC/2
  85.             icon and OS/2 will start PC/2 for you the next time you boot. This
  86.             holds not true if you have used the statement SET RESTARTOBJECTS=
  87.             STARTUPFOLDERSONLY in your CONFIG.SYS, then you must create an
  88.             PC/2 object/shadow in the startup folder.
  89.     *) PC/2 may be used instead of the WPS. In this case you need either to copy
  90.             PC2HOOK.DLL into a path pointed by LIBPATH environment variable in
  91.             CONFIG.SYS or to point the LIBPATH to the directory you installed
  92.             and run PC/2 from. PC2.HLP may either be in a path pointed to by
  93.             HELP or in the directory PC/2 is installed and running from.
  94.             Then edit your CONFIG.SYS to SET RUNWORKPLACE=[path]PC2.EXE. The
  95.             next time you boot, PC/2 has replaced your WPS. (Of course you can
  96.             then start the WPS from a OS/2 command prompt by typing START
  97.             PMSHELL or creating an entry in PC/2's Popup-Menu..
  98.     *) The syntax of PC/2 is:
  99.             PC2 [-Profile Filename.ext] [-[Double|Single]Click] or
  100.             PC2 [/Profile Filename.ext] [/[Double|Single]Click]
  101.             where Filename.ext may be any filename for FAT or HPFS filname
  102.             convention.
  103.             If you omit the optional profile name, the default profile
  104.             PC2.CFG is selected.
  105.             Specifying the option DoubleClick selects that the Popup-Menu
  106.             appears after a double-click on the Desktop instead of a single
  107.             click. If you don't specify any click option the option from
  108.             the PC/2 configuration file is taken.
  109.  
  110. Version 1.xx Hints:
  111.     *) PC/2 is currently under test, so there will be some misspells/
  112.             inconsistencies/bugs. PC/2 will NOT destroy any data under no
  113.             circumstances!
  114.     *) PC/2 only supports all seamless WIN-OS2 type sessions, if WPS Objects
  115.             that correspond the this sessions are created with MAKEOBJ.CMD, a
  116.             small REXX-utility supplied with PC/2.
  117.             Without a corresponding WPS Object defined, seamless WIN-OS2
  118.             support is limited to separate sessions.
  119.     *) PC/2 was developed and tested on two different PS/2s under OS/2 2.1 GA
  120.             (internal release 6.514) and OS/2 2.0 GA (internal release 6.307).
  121.             PC/2 was also tested to work with OS/2 2.11 (Service Pack for
  122.             OS/2 2.1 GA). 
  123.  
  124. You may contact me via (E-)Mail, if you have problems/suggestions/questions at:
  125.     *) Internet: RSTANGL@VNET.IBM.COM
  126.     *) FidoNet: Roman Stangl @ LA BAMBA BBS 2:310/14@fidonet.org
  127.        Tel.: (Int. Code +43 +1 +6898971)
  128.     *) FidoNet: Roman Stangl @ IBM Austria National Support BBS
  129.        Tel.: (Int. Code +43 +1 +21145-6600)
  130.     *) IBM VNET: 61821799 at VIEVMA
  131.     *) Roman Stangl
  132.        Strebersdorferstr. 46
  133.        A-2103 Langenzersdorf, Austria
  134.  
  135. If you find this utility useful and want to honor ten weeks of work, you are
  136. welcome to send me 50 to 150 Austrian Schilling (about 5 to 15 US Dollar) to
  137. my home address. Please send any donations in CASH, because its much easier
  138. for me to exchange foreign currency, than money orders, checks,...
  139. Of course, you don't need to pay again, if a new release comes out.
  140.  
  141. Because of the Freeware status of PC/2 I am n o t going to send new versions
  142. of PC/2 or anything else by mail (which is likely to become a never ending
  143. story), however I try my best to do support via E-Mail!
  144.  
  145. History:
  146. Version 1.00ß:  *) First public release
  147. Version 1.10:   *) Installation improved
  148.                 *) IDLE_SECONDS=10 and IDLE_SENSITIVITY=100 added for DOS
  149.                    sessions
  150.                 *) Source code now included
  151. Version 1.20:   *) All DOS Settings now configurable
  152.                 *) Standard file dialog can be used to find the application
  153.                    you want to install to PC/2
  154.                 *) PC/2 may now be used with or without the WPS - it may even
  155.                    replace the WPS.
  156.                 *) I know the bug occurring occasionally when deleting entries
  157.                    is not removed, but other things have a higher priority.
  158. Version 1.30:   *) CR, LF added to DOS Settings, if missing.
  159.                 *) DoubleClick command line option added, installation prompts
  160.                    the user, if he wants to install this option into the PC/2
  161.                    object. PC/2 now pops up after a double-click, if no click
  162.                    option or the option [-|/]DoubleClick is specified.
  163.                 *) ShutDown OS/2 entry and dialog box added.
  164.                 *) PC2.HLP may also be in the directory of PC/2 instead in a
  165.                    directory pointed by the HELP environment variable. The
  166.                    same applies for PC2HOOK.HLP and the LIBPATH environment
  167.                    variable. PC/2 first attempts to find these files, where
  168.                    it is started from, then in the paths included in the
  169.                    environment variables.
  170.                 *) Popup-Menu now don't select an entry, if button 1 is
  171.                    clicked at the bottom of the screen.
  172.                 *) PC2.c V1.20: 257, 564: File close of unopened files removed.
  173.                    Utility.c V1.20: 399, 457: Free of unallocated memory
  174.                    removed.
  175.                 *) DOS and OS/2 batch files automatically added as parameters
  176.                    to their command processors (HPFS names with spaces under
  177.                    two double-quotes).
  178.                 *) FAQ list added.
  179.                 *) Entry-removing bug solved.
  180.                 *) Directory changed to root if only drive is entered as the
  181.                    working directory.
  182.                 *) User enterable commandline-parameter at run-time added.
  183.                    Now you may enter commandline-parameters immediately before
  184.                    an application is launched.
  185. Version 1.40:   *) WPS Objects may now be started too by PC/2, even if they are
  186.                    seamless WIN-OS2 session.
  187.                 *) PC/2 changes to the root of each non-removable media
  188.                    attached to your system, except for the defined working
  189.                    directory.
  190.                 *) Drag & Drop is not supported.
  191.                 *) PC/2 checks every 2.5 if the Desktop window handle changes,
  192.                    so if you run PC/2 as a WPS replacement you can start
  193.                    PMSHELL without needing to close PC/2 once after PMSHELL
  194.                    is ready.
  195.                 *) You can now resort (Sub)menus manually.
  196. Version 1.50:   *) PC/2 configuration file completely rewritten. Should avoid
  197.                    redundant storage and increase fault tolerance. Downwards
  198.                    compatible, so old files can be read, but will be written
  199.                    in the improved format. Some more useful demos, that you
  200.                    may incorporate in your configuration by using an editor,
  201.                    added.
  202.                 *) Optional sliding focus a-la X-Windows added (thanks to
  203.                    Markus Hof and Roman Fischer for providing their source
  204.                    code of XFEEL as a valuable basis).
  205.                 *) Optional virtual Desktop added, that expands your physical
  206.                    Desktop to a 9-fold virtual Desktop (thanks to Carrick von
  207.                    Schoultz for giving me the tip to use the flag
  208.                    SWP_NOADJUST).
  209.                 *) Code that handled priority settings completely removed,
  210.                    because applications can't be started as parent process/
  211.                    child process which would be required to change the
  212.                    priority of processes.
  213.                 *) PC/2 now traces clicks both on the WPS and/or PM, so
  214.                    you can move the WPS into the virtual Desktop and click
  215.                    on the PM.
  216.                 *) PC/2 now maps the coordinates on the window, where you
  217.                    clicked, to the coordinates of the display. This should
  218.                    avoid bad positioning of the Popup-Menu (PC/2 now
  219.                    works together with 9LIVES).
  220.                 *) Code that changed to the root directories now should also
  221.                    work, if a removable media is inserted, but not a valid
  222.                    file system (f.e. a CD-ROM with a music-CD inserted)
  223.                    (thanks to Mario Semo for his assistance with DosDevIOCtl).
  224. Version 1.60:   *) Seamless WIN-OS2 support added, only separate sessions
  225.                    and under 2.0 GA with WPS installed though. Thanks to
  226.                    Alex Stewart for pointing me out how to do this.
  227.                 *) Fixed not moving minimized windows (icons) when Desktop
  228.                    is moved.
  229.                 *) For sliding Focus added a flag to preserve Z-order of
  230.                    the windows.
  231.                 *) ShutDown message now changes if ShutDown completed.
  232.                 *) Enhanced MakeObj utility, thanks to Ingo Pflanz for his
  233.                    work on this.
  234.                 *) Now PC/2 should also work with networked drives, at least
  235.                    it works with NFS-mounted drived with IBM's TCPIP 1.2.1.
  236. Version 1.70:   *) First release of a "IBM internal use only" version on
  237.                    OS2TOOLS.
  238.                 *) PC/2s popup menu now completely configurable, even PC/2s
  239.                    Setup, Config, About, Help, Exit and ShutDown options.
  240.                 *) The Program Installation dialog is now a notebook.
  241.                 *) Separators and Break separators are now supported to
  242.                    improve the clarity of the Popup-Menu.
  243.                 *) Exit PC/2 and ShutDown OS/2 message boxes now default
  244.                    to OK, to just press Enter to perform action.
  245.                 *) PC/2 now supports user defined Hotkeys to be used to
  246.                    switch to sessions, even on another virtual Desktop,
  247.                    directly. 72 different keys are available. If the
  248.                    application, the Hotkey is defined for, is not running
  249.                    PC/2 launches it.
  250.                 *) PC/2 supports to specify the priority of a program to
  251.                    launch.
  252.                 *) Window List support on PM background. This is useful
  253.                    if you are not running OS/2 with the WPS (which saves
  254.                    up to 4 MB memory).
  255.                 *) PC/2 now saves it's size & position along with the
  256.                    default click flag.
  257.                 *) Overview window improved, you may directly switch to any
  258.                    virtual Desktop just by doubleclicking with mouse button
  259.                    1 on the overview window.
  260.                 *) Bug fixed, that dismissed the ShutDown dialog by pressing
  261.                    the ESC-Key.
  262.                 *) SMALLFNT.CMD supplied that replaces the standard system
  263.                    font (10pt. proportional Systemfont) by a smaller 8pt.
  264.                    Helv font. Applying this batch file and rebooting reduces
  265.                    the size of most dialogs to about 2/3 of the previous
  266.                    size, giving you more "workspace" on your Desktop.
  267.                 *) Smarticons added to improve control of windows on PC/2's
  268.                    overview window. Thanks to Michael Wakunda for helping me
  269.                    designing the icons.
  270.                 *) Support for EMX C/C++ added upon a suggestion from Rolf
  271.                    Knebel.
  272.                 *) The user defined position now works, even if the
  273.                    application decides to use its own position.
  274.                 *) PC2HOOK.DLL is now statically linked, and PC/2 is now a
  275.                    multithreaded application.
  276.                 *) The overview window now displays a scaled image of the
  277.                    Virtual Desktop. The windows are named and can be
  278.                    manipulated by applying the currently active smarticon
  279.                    with mouse button 2.
  280.                 *) PC/2's configuration file was enhanced to support the new
  281.                    features. You may use the configuration file from a
  282.                    previous version of PC/2, it will be upgraded the first
  283.                    time you make modifications (and you need to add the
  284.                    Configure Popup-Menu Setting when upgrading).
  285.                 *) You may enable mouse button 2 clicks on a window's title-
  286.                    bar to set this window to the bottom (lowering its
  287.                    Z-Order). Thanks to Rolf Knebel for sending me this
  288.                    suggestion coded into PC/2, although I changed it little
  289.                    bit.
  290.  
  291. Planned enhancements:
  292.     *) Complete seamless WIN-OS2 support. Please email me, if you know how to
  293.        implement this (no separate sessions, working w/ or w/o WPS under all
  294.        OS/2 2.x versions)! - Thanks!
  295.  
  296. Please read the help panels and enjoy! Roman Stangl
  297.  
  298.